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Typescript 


Typescript is an open-source programming language developed and 
maintained by Microsoft. It is a strict syntactical superset of 
JavaScript, and adds optional static typing to the language. 

Typescript is designed for development of large applications and 
transcompiles to JavaScript. [5] As Typescript is a superset of 
JavaScript, existing JavaScript programs are also valid Typescript 
programs. Typescript may be used to develop JavaScript applications 
for both client-side and server-side (Node.js) execution. 

There are multiple options available for transcompilation. Either the 
default Typescript Checker can be used, [6] or the Babel compiler can 
be invoked to convert Typescript to JavaScript. 171 

Typescript supports definition files that can contain type information 
of existing JavaScript libraries, much like C++ header files can 
describe the structure of existing object files. This enables other 
programs to use the values defined in the files as if they were 
statically typed Typescript entities. There are third-party header files 
for popular libraries such as jQuery, MongoDB, and D3.js. Typescript 
headers for the Node.js basic modules are also available, allowing 
development of Node.js programs within Typescript. 181 

The Typescript compiler is itself written in Typescript and compiled 
to JavaScript. It is licensed under the Apache License 2.0. 

Typescript is included as a first-class programming language in 
Microsoft Visual Studio 2013 Update 2 and later, beside C# and other 
Microsoft languages.An official extension allows Visual Studio 2012 
to support Typescript as well. [10] 

Anders Hejlsberg, lead architect of C# and creator of Delphi and 
Turbo Pascal, has worked on the development of 
Typescript .U 1 Hi2][t3][i4] 
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History 

Typescript was first made public in October 2012 (at version 0.8), after two years of internal development at 
Microsoft. [15][16] Soon after the announcement, Miguel de Icaza praised the language itself, but criticized the 
lack of mature IDE support apart from Microsoft Visual Studio, which was not available on Linux and OS X at 
that time. 11711181 Today there is support in other IDEs, particularly in Eclipse, via a plug-in contributed by 
Palantir Technologies. [19][20] Various text editors, including Emacs, Vim, Sublime, Webstorm, Atom 1211 and 
Microsoft's own Visual Studio Code also support TypeScript. [22] 

Typescript 0.9, released in 2013, added support for generics. [23] Typescript 1.0 was released at Microsoft's 
Build developer conference in 2014. [24] Visual Studio 2013 Update 2 provides built-in support for 
TypeScript. [25] 

In July 2014, the development team announced a new Typescript compiler, claiming 5x performance gains. 
Simultaneously, the source code, which was initially hosted on CodePlex, was moved to GitHub. 1261 

On 22 September 2016, Typescript 2.0 was released; it introduced several features, including the ability for 
programmers to optionally prevent variables from being assigned null values, [27] sometimes referred to as 
the billion-dollar mistake. 

Design 

Typescript originated from the shortcomings of JavaScript for the development of large-scale applications 
both at Microsoft and among their external customers. [28] Challenges with dealing with complex JavaScript 
code led to demand for custom tooling to ease developing of components in the language. [29] 

Typescript developers sought a solution that would not break compatibility with the standard and its cross¬ 
platform support. Knowing that the current ECMAScript standard proposal promised future support for class- 
based programming, Typescript was based on that proposal. That led to a JavaScript compiler with a set of 
syntactical language extensions, a superset based on the proposal, that transforms the extensions into regular 
JavaScript. In this sense Typescript was a preview of what to expect of ECMAScript 2015. A unique aspect not 
in the proposal, but added to Typescript, is optional static typing 1301 that enables static language analysis, 
which facilitates tooling and IDE support. 


ECMAScript 2015 support 

Typescript adds support for features such as classes, modules, and an arrow function syntax as defined in the 
ECMAScript 2015 standard. 





Features 


Typescript is a language extension that adds features to ECMAScript 6. Additional features include: 

■ Type annotations and compile-time type checking 

■ Type inference 

■ Type erasure 

■ Interfaces 

■ Enumerated types 

■ Generics 

■ Namespaces 

■ Tuples 

■ Async/await 

The following features are backported from ECMAScript 2015: 

■ Classes 

■ Modules^ 31 ! 

■ Abbreviated "arrow" syntax for anonymous functions 

■ Optional parameters and default parameters 

Syntactically, Typescript is very similar to JScript .NET, another Microsoft implementation of the ECMA-262 
language standard that added support for static typing and classical object-oriented language features such as 
classes, inheritance, interfaces, and namespaces. 


Compatibility with JavaScript 

Typescript is a strict superset of ECMAScript 2015, which is itself a superset of ECMAScript 5, commonly 
referred to as JavaScript. [32] As such, a JavaScript program is also a valid Typescript program, and a 
Typescript program can seamlessly consume JavaScript. By default the compiler targets ECMAScript 5, the 
current prevailing standard, but is also able to generate constructs used in ECMAScript 3 or 2015. 

With Typescript, it is possible to use existing JavaScript code, incorporate popular JavaScript libraries, and 
call TypeScript-generated code from other JavaScript. 1331 Type declarations for these libraries are provided 
with the source code. 


Type annotations 

Typescript provides static typing through type annotations to enable type checking at compile time. This is 
optional and can be ignored to use the regular dynamic typing of JavaScript. 

r- — - -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- — — n 

! function add(left: number, right: number): number { 

| return left + right; 
i } 


The annotations for the primitive types are number, boolean and string. Weakly- or dynamically-typed 
structures are of type any. 

Type annotations can be exported to a separate declarations file to make type information available for 
Typescript scripts using types already compiled into JavaScript. Annotations can be declared for an existing 
JavaScript library, as has been done for Node.js and jQuery. 

The Typescript compiler makes use of type inference to infer types when types are not given. For example, 
the add method in the code above would be inferred as returning a number even if no return type annotation 
had been provided. This is based on the static types of left and right being numbers, and the compiler's 





















knowledge that the result of adding two numbers is always a number. However, explicitly declaring the return 
type allows the compiler to verify correctness. 

If no type can be inferred because of lack of declarations, then it defaults to the dynamic any type. A value of 
the any type supports the same operations as a value in JavaScript and minimal static type checking is 
performed for operations on any values. [34] 


Declaration files 

When a Typescript script gets compiled there is an option to generate a declaration file (with the extension 
.d.ts) that functions as an interface to the components in the compiled JavaScript. In the process the 
compiler strips away all function and method bodies and preserves only the signatures of the types that are 
exported. The resulting declaration file can then be used to describe the exported virtual Typescript types of a 
JavaScript library or module when a third-party developer consumes it from Typescript. 

The concept of declaration files is analogous to the concept of header file found in C/C++. 


declare namespace arithmetics { 

add(left: number, right: number): number; 
subtract(left: number, right: number): number; 
multiply(left: number, right: number): number; 
divide(left: number, right: number): number; 

} 


Type declaration files can be written by hand for existing JavaScript libraries, as has been done for jQuery 
and Node.js. 

Large collections of declaration files for popular JavaScript libraries are hosted on GitHub in DefinitelyTyped 
(https://github.com/DefinitelyTyped/DefinitelyTyped). 


Classes 

Typescript supports ECMAScript 2015 classes that integrate the optional type annotations support. 


class Person { 

private name: string; 
private age: number; 
private salary: number; 

constructor(name : string, age: number, salary: number) { 
this. name name; 
this. age = age; 
this. salary = salary; 

} 

toString(): string { 

return '${this .name} (${this .age}) (${this. salary})'; //As of version 1.4 

} 


Generics 

Typescript supports generic programming. [35] 


function doSomething<T>(arg: T): T { 
return arg; 

} 










Modules and namespaces 

Typescript distinguishes between modules and namespaces. Both features in Typescript support 
encapsulation of classes, interfaces, functions and variables into containers. Namespaces (formerly internal 
modules) utilize immediately-invoked function expression of JavaScript to encapsulate code, whereas 
modules (formerly external modules) leverage JavaScript library patterns to do so (AMD or CommonJS). 1361 

Development tools 


Compiler 

The Typescript compiler, named tsc, is written in Typescript. As a result, it can be compiled into regular 
JavaScript and can then be executed in any JavaScript engine (e.g. a browser). The compiler package comes 
bundled with a script host that can execute the compiler. It is also available as a Node.js package that uses 
Node.js as a host. 

There is also an alpha version of a client-side compiler in JavaScript, which executes Typescript code on the 
fly, upon page load. [37] 

The current version of the compiler supports ECMAScript 5 by default. An option is allowed to target 
ECMAScript 2015 to make use of language features exclusive to that version (e.g. generators). Classes, despite 
being part of the ECMAScript 2015 standard, are available in both modes. 


IDE and editor support 

■ Microsoft provides a plug-in for Visual Studio 2012 and WebMatrix, full integrated support in Visual Studio 2013, 
Visual Studio 2015, and basic text editor support for Sublime Text, Emacs and Vim.! 38 ! 

■ Visual Studio Code is a (mostly) open-source, cross-platform source code editor developed by Microsoft based on 
Electron. It supports TypeScript in addition to several other languages, and offers features like debugging and 
intelligent code completion. 

■ alm.tools is an open source cloud IDE for TypeScript built using TypeScript, ReactJS and TypeStyle. 

■ JetBrains supports TypeScript with code completion, refactoring and debugging in its IDEs built on IntelliJ 
platform, such as PhpStorm 6, WebStorm 6, and IntelliJ IDEA,! 39 ! as we || as their Visual Studio Add-in and 
extension, ReSharper (https://www.jetbrains.com/resharper) 8.1 .! 4 °] 

■ Atom has a TypeScript Plugin (https://atom.io/packages/atom-typescript) by Basarat with support for code 
completion, navigation, formatting, and fast compilation. 

■ The online Cloud9 IDE and Codenvy support TypeScript. 

■ A plugin is available for the NetBeans IDE. 

■ A plugin is available for the Eclipse IDE (version Kepler) 

■ TypEcs is available for the Eclipse IDE. 

■ Microsoft provides a TypeScript Plugin for Sublime Text. 

■ The Cross Platform Cloud IDE Codeanywhere supports TypeScript. 

■ Webclipse An Eclipse plugin designed to develop TypeScript and Angular 2. 

■ Angular IDE A standalone IDE available via npm to develop TypeScript and Angular 2 applications, with integrated 
terminal support. 

■ Tide - TypeScript Interactive Development Environment for Emacs. 

■ Tsuquyomi (https://github.com/Quramy/tsuquyomi) - a Vim plugin which uses TSServer and provides features like 
code completion, navigation and syntax and semantic error checking. 


Integration with build automation tools 




Using plug-ins, Typescript can be integrated with build automation tools, including Grunt (grunt-ts 1411 ), 
Apache Maven (Typescript Maven Plugin 1421 ), Gulp (gulp-typescript 1431 ) and Gradle (Typescript Gradle 
Plugin 1441 )- 

Linting tools 

TSLint [45] scans Typescript code for conformance to a set of standards and guidelines. ESLint, a standard 
JavaScript linter, also provided some support for Typescript via community plugins. However, ESLint's 
inability to leverage Typescript's language services precluded certain forms of semantic linting and program¬ 
wide analysis. [46] In early 2019, the TSLint team announced the linter's deprecation in favor of typescript- 
eslint, a joint effort of the TSLint, ESLint and Typescript teams to consolidate linting under the ESLint 
umbrella for improved performance, community unity and developer accessibility. [47] 


Release history 



Version 

number 

Release date 

Significant changes 

0.8 

1 October 2012 


0.9 

18 June 2013 


1.1 

6 October 2014 

performance improvements 

1.3 

12 November 2014 

protected modifier, tuple types 

1.4 

20 January 2015 

union types, let and const declarations, template strings, type guards, type 
aliases 

1.5 

20 July 2015 

ES6 modules, namespace keyword, for . .of support, decorators 

1.6 

16 September 2015 

JSX support, intersection types, local type declarations, abstract classes and 
methods, user-defined type guard functions 

1.7 

30 November 2015 

async and await support, 

1.8 

22 February 2016 

constraints generics, control flow analysis errors, string literal types, allowJs 

2.0 

22 September 2016 

null- and undefined-aware types, control flow based type analysis, 
discriminated union types, never type, readonly keyword, type of this for 
functions 

2.1 

8 November 2016 

keyof and lookup types, mapped types, object spread and rest, 

2.2 

22 February 2017 

mix-in classes, object type, 

2.3 

27 April 2017 

async iteration, generic parameter defaults, strict option 

2.4 

27 June 2017 

dynamic import expressions, string enums, improved inference for generics, 
strict contravariance for callback parameters 

2.5 

31 August 2017 

optional catch clause variables 

2.6 

31 October 2017 

strict function types 

2.7 

31 January 2018 

constant-named properties, fixed length tuples 

2.8 

27 March 2018 

conditional types, improved keyof with intersection types 

2.9 

14 May 2018 

support for symbols and numeric literals in keyof and mapped object types 

3.0 

30 July 2018 

project references, extracting and spreading parameter lists with tuples 

3.1 

27 September 2018 

mappable tuple and array types 

3.2 

30 November 2018 

stricter checking for bind, call, and apply 

3.3 

31 January 2019 

relaxed rules on methods of union types, incremental builds for composite 
projects 

3.4 

29 March 2019 

faster incremental builds, type inference from generic functions, readonly 
modifier for arrays, const assertions, type-checking globalThis 

3.5 

29 May 2019 

faster incremental builds, omit helper type, improved excess property checks in 
union types, smarter union type checking 

3.6 

28 August 2019 

Stricter generators, more accurate array spread, better Unicode support for 
identifiers 


See also 

■ Dart 

■ Elm 

■ Reason 
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